home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / file-tra / fsp-2.7 / fsp-2 / fsp / vms / install.vms < prev    next >
Encoding:
Text File  |  1993-05-19  |  7.5 KB  |  186 lines

  1. VMS-fsp V2.7.0 INSTALLATION information                      May 17, 1993
  2. =======================================
  3.  
  4. What's this?
  5.  
  6. This package contains the VMS port of FSP V2.7.0. At this moment it's just
  7. a beta-version, not all functions are tested thoroughly.
  8. The current version will run properly on VMS systems with UCX/TCP network
  9. software and some systems with Multinet/UCX. For other implementations,
  10. modifications might be needed in the header- and makefiles.
  11.  
  12.  
  13. What's different from the original FSP?
  14.  
  15. Well, the answer is the same as on the question "what's different between
  16. Unix and VMS": A lot! But the main difference related to FSP is the
  17. filesystem. A lot of changes had to made in the naming conventions of files
  18. and directories. And some Unix filesystem-functions do not even exist on
  19. VMS. So some additional emulation-functions were needed. At last, the Csh
  20. aliases script had to be converted to a DCL script.
  21.  
  22.  
  23. How to install it on my VMS?
  24.  
  25. If you have:
  26. 1. enough diskspace free (a meg or so should be enough).
  27. 2. UCX/TCP, or Multinet/UCX network software.
  28. 3. The normal VAX/C compiler.
  29. It should be possible.
  30.  
  31. Installing the client software:
  32. ------------------------------
  33. The normal FSP client software consists out of 14 separate executable, each
  34. executable represents an FSP-command (e.g. there's a file called FLSCMD.EXE
  35. to list files on a fsp-site). If you run out of diskspace, you can also use
  36. the 'merged' version. In this version all separate files are included in
  37. one executable, called FMERGE.EXE. (see: "Installing the client merge file")
  38.  
  39.  
  40. Installing the client software with DCL:
  41. ---------------------------------------
  42. To start the compilation, just type @MAKECLIENT from within the [.FSP.VMS]
  43. directory. Be sure that you didn't change any files or directory, leave it
  44. all in it's original state (See the file [.FSP]FILES. for the correct 
  45. content of the FSP-package).
  46.  
  47. When the MAKECLIENT script is started you will have to see some compiling
  48. and linking messages. If an error occures, the script will just stop on the
  49. last compiled/linked file.
  50.  
  51.  
  52. Installing the client software with MMS:
  53. ---------------------------------------
  54. If you have the VAX/MMS package on your machine, you can use this program
  55. to compile/link VMS-FSP also. This is the way to do it:
  56.  
  57. For UCX/TCP:      type: $mms /macro=(UCX=1)
  58.  
  59. For Multinet/UCX: type: $mms /macro=(MUL=1)
  60.  
  61. On Multinet systems which don't have the UCX$IPC library (do this only 
  62. when the normal Multinet-installation produces errors during linking):
  63.                   type: $mms /macro=(LIB=1)
  64.  
  65.  
  66. Installing the client merge file:
  67. --------------------------------
  68. The merged clients have the same functionality as the separated executables,
  69. produced by above installations. The only advantage is that they consume
  70. less diskspace. To make a mergefile, type @MAKEMERGE from within the
  71. [.fsp.vms]. Again a lot of notices will appear on the screen. When it's
  72. finished it asks to delete the (unnecessary) *.OBJ files. Just enter Y (you
  73. want to save diskspace, don't you?). Now a file called FMERGE.EXE should
  74. stand on your [.FSP] directory.
  75.  
  76.  
  77. Starting the clients:
  78. --------------------
  79. When everything worked out well, you have now to edit the path to your
  80. fsp-executables in the SETUP.COM file on line 15. This file is used for
  81. one-time configuration of FSP; it defines all commands and their
  82. corresponding executable. Use an ABSOLUTE path when you change it (e.g.
  83. DEVICE:[DIRECTORY.FSP] ).
  84. You can also change the default FSP-host/port, currently it is set to
  85. our FSP-site on the University of Technology in Eindhoven (The Netherlands)
  86. Copy also the file [.fsp.vms]FSP.COM to the same directory where the 
  87. client executable(s) are located.
  88.  
  89. To initialize FSP type @SETUP once (from within the [.fsp.vms] directory)
  90. or include the SETUP.COM file in your LOGIN.COM and login again.
  91. From now on you can use the FSP clients. Read the [.fsp.man]*.1 files for
  92. more information about a FSP command.
  93.  
  94. The merged version uses a different setup-file, called SETUPMERGE. Modify &
  95. start this file in the same way as described above.
  96.  
  97.  
  98. Installing the server software:
  99. ------------------------------
  100. The server software is only needed when you want to run an FSP-site
  101. yourself. If you only want to access other sites, just skip this part.
  102.  
  103.  
  104. Installing the server software with DCL:
  105. ---------------------------------------
  106. To start the compilation and linking of the server, enter @MAKESERVER from
  107. within the [.fsp.vms] directory. You will see some notices about from the
  108. compiler on your screen. If an error occures it will stop immediately on
  109. the last compiled file.
  110.  
  111.  
  112. Installing the server software with MMS:
  113. ---------------------------------------
  114. If you have the VAX/MMS package on your machine, you can install the
  115. server software in the following way:
  116.  
  117. For UCX/TCP:      type: $mms /macro=(UCX=1) server
  118.  
  119. For Multinet/UCX: type: $mms /macro=(MUL=1) server
  120.  
  121. On Multinet systems which don't have the UCX$IPC library (do this only 
  122. when the normal Multinet-installation produces errors during linking):
  123.                   type: $mms /macro=(LIB=1) server
  124.  
  125.  
  126. Starting the server:
  127. -------------------
  128. The way to start the server is the same as with the BSD version of FSP.
  129. Before you can start it, you need to make some changes in the configuration
  130. file FSPD.CONF. A template is located in [.fsp.vms], comments are included.
  131.  
  132. After you made the modifications, enter $FSPD -f fspd.conf
  133. to start the server with your configuration file. Ofcourse you can use
  134. any device/directory/filename instead of 'fspd.conf'.
  135. When you enter FSPD without any arguments, it reads the configuration-
  136. parameters from the default file SYS$LOGIN:FSPD.CONF.
  137.  
  138. To start the server as a detached process (so you can log out, while the
  139. server keeps running), use the RUNFSPD.COM file in the [.FSP.VMS] directory.
  140. It needs the DEFAULT name of the configuration-file (SYS$LOGIN:FSPD.CONF). 
  141.  
  142. After starting the server with RUNFSPD, you can only stop it by using the
  143. KILL or STOP command (enter the Process ID or the processname (FSPD) of
  144. the server as argument).
  145.  
  146. When you want to run a server on a timeschedule, you can use the RESUBFSP.COM
  147. file. It's a sample DCL-script to show the combination of an FSP-server and
  148. the away-daemon in a batch-process.
  149.  
  150. For more information about using the server, read the files fspd.1 or INFO.
  151.  
  152.  
  153. What will be next?
  154. -----------------
  155. Unfortunately I'm no student anymore, so I don't have much time to keep
  156. up with the latest FSP-versions. When someone wants to take it over, please
  157. do! There's still much work to do, like making an CMU/TEK, TGV and
  158. Wollongong version.
  159. Anyways, look on 128.2.206.138 port 30 or 131.155.2.71 port 21 for the
  160. latest FSP versions.
  161.  
  162.  
  163. Where to send questions/suggestions/bugreports/etc to?
  164. -----------------------------------------------------
  165. For the VMS-fsp only, send them to S.A.Pechler@bdk.tue.nl (that's me) or
  166. bdaasp@rc5.urc.tue.nl (that's also me) if the first address bounces.
  167. Occasionally I will be present on IRC, with nick Leo (watch it; there are
  168. a lot of people with that nickname on IRC!).
  169. For the BSD-fsp you can email to wen-king@vlsi.cs.caltech.edu or to
  170. Joseph_Traub@SEISMO.SOAR.CS.CMU.EDU (the 'JT' and 2.7.x versions).
  171.  
  172.  
  173. Have fun with it.
  174.  
  175. -Sven <S.A.Pechler@bdk.tue.nl>
  176.  
  177.  
  178. My thanx go to:
  179. Xanadude (for the help in debugging the server),
  180. wen-king (for realizing FSP),
  181. Joseph_Traub (for the updates),
  182. McFly (for the beta-testing and Multinet support),
  183. Jean Francois Burdet (also for testing and Multinet support).
  184. Ivan Saez (for letting me run the CPU-eating server on this VMS-machine).
  185. ===========================================================================
  186.